Image Generation
Image Generation
Image Generation MCP 서버는 Replicate Flux 모델을 활용한 이미지 생성 기능을 제공합니다. 이 서버를 통해 LLM은 텍스트 프롬프트를 기반으로 다양한 스타일의 고품질 이미지를 생성할 수 있습니다. 텍스트-이미지 변환 모델을 사용하여 사용자 지정 가능한 이미지 생성, 스타일 적용, 이미지 변형 등 다양한 시각적 콘텐츠 제작이 가능합니다.
특징
- 텍스트 기반 이미지 생성: 자연어 설명에서 고품질 이미지 생성
- 다양한 스타일 지원: 사실적, 추상적, 예술적 등 다양한 스타일 적용
- 이미지 크기 및 형식 제어: 해상도, 비율, 출력 형식 조정
- 프롬프트 최적화: 효과적인 이미지 생성을 위한 프롬프트 개선
- 배치 처리: 여러 이미지의 동시 생성 및 관리
- 모델 선택: 다양한 Replicate 모델과 매개변수 조정
- 이미지 수정: 기존 이미지 변형 및 스타일 전이
- 합성 및 인페인팅: 이미지 합성 및 영역 재생성
API
도구
기본 이미지 생성 도구
- generate_image: 텍스트 프롬프트에서 이미지 생성
- 입력: 텍스트 프롬프트, 이미지 크기, 모델 매개변수
-
출력: 생성된 이미지 URL 또는 바이너리 데이터
-
generate_variants: 기존 이미지의 변형 생성
- 입력: 기준 이미지, 변형 강도, 변형 수
-
출력: 생성된 변형 이미지 배열
-
batch_generate: 여러 프롬프트의 일괄 처리
- 입력: 프롬프트 배열, 공통 설정
- 출력: 생성된 이미지 배열
고급 생성 도구
- style_transfer: 스타일 전이 적용
- 입력: 콘텐츠 이미지, 스타일 이미지 또는 스타일 설명
-
출력: 스타일이 적용된 이미지
-
image_inpainting: 이미지 영역 재생성
- 입력: 기본 이미지, 마스크, 채우기 프롬프트
-
출력: 재생성된 이미지
-
image_upscaling: 이미지 해상도 향상
- 입력: 저해상도 이미지, 확대 비율, 품질 설정
- 출력: 고해상도 이미지
유틸리티 도구
- optimize_prompt: 이미지 생성 프롬프트 최적화
- 입력: 기본 프롬프트, 스타일 힌트
-
출력: 최적화된 프롬프트
-
list_models: 사용 가능한 모델 목록 조회
- 입력: 필터링 기준(선택적)
-
출력: 모델 목록 및 설명
-
get_model_params: 특정 모델의 매개변수 조회
- 입력: 모델 ID
- 출력: 매개변수 목록 및 기본값
사용 방법
설치
# npm을 통한 설치
npm install -g image-generation-mcp
# 또는 GitHub 저장소에서 직접 설치
git clone https://github.com/author/image-generation-mcp
cd image-generation-mcp
npm install
필요 조건
- Replicate API 키가 필요합니다.
- Node.js 14 이상이 설치되어 있어야 합니다.
구성
Claude Desktop에서 이 서버를 사용하려면 다음과 같이 설정할 수 있습니다:
{
"mcpServers": {
"image-generation": {
"command": "npx",
"args": ["-y", "image-generation-mcp"],
"env": {
"REPLICATE_API_KEY": "YOUR_API_KEY",
"OUTPUT_DIRECTORY": "/path/to/output"
}
}
}
}
사용 예시
// 기본 이미지 생성
const image = await generate_image({
prompt: "한국 전통 한옥이 있는 산속 마을, 안개가 자욱한 아침, 사실적 스타일",
width: 1024,
height: 768,
model: "stability-ai/sdxl",
parameters: {
num_inference_steps: 50,
guidance_scale: 7.5
}
});
console.log(`이미지 생성 완료: ${image.url}`);
// 스타일 전이 적용
const styledImage = await style_transfer({
content_image: "/path/to/photo.jpg",
style_prompt: "반 고흐의 별이 빛나는 밤 스타일",
strength: 0.8
});
console.log(`스타일 적용 완료: ${styledImage.url}`);
// 배치 처리로 여러 변형 생성
const prompts = [
"산 속 전원 주택, 가을, 해질녘",
"산 속 전원 주택, 겨울, 눈 내리는 아침",
"산 속 전원 주택, 봄, 꽃이 만발한 정오"
];
const batchResults = await batch_generate({
prompts: prompts,
width: 768,
height: 768,
model: "stability-ai/sdxl"
});
console.log(`${batchResults.length}개의 이미지가 생성되었습니다.`);
연결된 구성 요소
- EverArt - 다양한 AI 이미지 생성 모델과의 통합
- Blender - 생성된 이미지를 3D 텍스처 및 참조로 활용
- Office-PowerPoint-MCP-Server - 생성된 이미지를 프레젠테이션에 통합
- YouTube - 생성된 이미지로 썸네일 및 비디오 자산 제작